home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / util / misc / SplitIndex.readme < prev    next >
Text File  |  1997-05-03  |  3KB  |  105 lines
  1. Short:    Aminet INDEX Split and Filter Utility
  2. Author:   dhomas@youngmonkey.ca
  3. Uploader: dhomas@youngmonkey.ca
  4. Version:  97.Mar.17
  5. Type:     util/misc
  6.  
  7. *****************************************
  8.  
  9.    SplitIndex.rexx (97.Mar.17)
  10.  
  11.    Author: dhomas trenn
  12.     EMail: dhomas@youngmonkey.ca
  13.       WWW: www.youngmonkey.ca
  14.  
  15. *****************************************
  16.  
  17.  
  18. INTRODUCTION
  19. ------------
  20.  
  21. As everyone knows, the Aminet INDEX is BIG, and becoming unmanagable as
  22. a single file.  Also, it contains many listings that some people are
  23. not at all interested in.
  24.  
  25. Many people have tried to reduce the amount of time required to search
  26. through this file by writing programs with numerous search options.
  27. Most of these programs require many hours to pre-parse the INDEX file.
  28. In my opinion, this is unacceptable.
  29.  
  30. I find it easier to just double click on the INDEX file in DirOpus and
  31. do a quick search.  But this requires a lot of memory to load the full
  32. INDEX file.  My solution, SplitIndex.rexx, a program that took me about
  33. 10 minutes to code.
  34.  
  35. SplitIndex.rexx is a small ARexx program that parses the INDEX file,
  36. filtering out any unwanted information (configurable) and spliting the
  37. file into separate files for each directory.  It only takes a few
  38. minutes to parse the entire file.  It is fast enough to do on a regular
  39. basis.
  40.  
  41.  
  42. CONFIGURATION
  43. -------------
  44.  
  45. The following variables can be defined within the ARexx program itself.
  46. They are at the very top of the program and can be edited with any text
  47. editor.
  48.  
  49.   Index
  50.   -----
  51.     Defines the location of the INDEX file.  If this file can not be
  52.     found the program will error and abort.  Upon completion of the
  53.     program this index file will be deleted.
  54.  
  55.  
  56.     Example: Index = "TEMP:INDEX"
  57.  
  58.   IndexesPath
  59.   -----------
  60.     Defines the path to store the split index files.  This must be the
  61.     full path.  This path must exist already.  The program will not
  62.     create it.  If the directory can not be found the program will
  63.     error and abort.
  64.  
  65.  
  66.     Example: IndexesPath = "Storage:PD/.indexes/"
  67.              IndexesPath = "Storage:"
  68.  
  69.   IgnoreDir
  70.   ---------
  71.     Defines any directories that should be filtered out.  All sub
  72.     directories will also be ignored.  Multiple entries MUST be
  73.     separated with a single space.
  74.  
  75.     Example: IgnoreDir = "demo mods"
  76.              IgnoreDir = "demo"
  77.              IgnoreDir = ""                < to disable Dir filtering
  78.  
  79.  
  80.   IgnoreSub
  81.   ---------
  82.     Defines any sub directories that should be filtered out.
  83.  
  84.     Example: IgnoreSub = "biz/cloan comm/ambos"
  85.              IgnoreSub = "biz/cloan"
  86.              IgnoreSub = ""                < to disable Sub filtering
  87.  
  88.  
  89. STARTING
  90. --------
  91.  
  92. From the Shell:
  93.  
  94.   rx SplitIndex
  95.  
  96.  
  97. ============================= Archive contents =============================
  98.  
  99. Original  Packed Ratio    Date     Time    Name
  100. -------- ------- ----- --------- --------  -------------
  101.     2704    1142 57.7% 17-Mar-97 13:08:08  SplitIndex.readme
  102.     1337     644 51.8% 17-Mar-97 13:02:54  SplitIndex.rexx
  103. -------- ------- ----- --------- --------
  104.     4041    1786 55.8% 18-Mar-97 15:40:54   2 files
  105.